package com.habdqn.mybatis.demo.dao;

import com.habdqn.mybatis.demo.entity.User;
import com.habdqn.mybatis.demo.entity.example.UserExample;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Select;

import java.util.List;

/**
 * @author Xing Jiejian 2019-10-29
 */
public interface UserDao {
    /**
     * 保存单个用户
     *
     * @param user
     * @return
     */
    int saveUser(User user);

    /**
     * 批量保存用户
     *
     * @param users
     * @return
     */
    int saveUsers(List<User> users);

    /**
     * 根据主键更新用户对象，只更新非空的属性
     *
     * @param user
     * @return
     */
    int update(User user);

    /**
     * 根据主键删除用户
     *
     * @param id
     * @return
     */
    int deleteById(int id);

    /**
     * 根据主键的数组批量删除用户
     *
     * @param ids id的数组
     * @return
     */
    int deleteByIds(int[] ids);

    /**
     * 根据主键获取对象
     *
     * @param id
     * @return
     */
    User queryById(int id);

    /**
     * 根据主键获取对象（同时关联部门对象）
     *
     * @param id 主键
     * @return 关联对应部门的用户
     */
    User queryByIdWithDept(int id);

    /**
     * 分页查询用户
     *
     * @param offset
     * @param limit
     * @return
     */
    List<User> queryAll(@Param("offset") Integer offset, @Param("limit") Integer limit);

    /**
     * 根据Example对象查询用户
     *
     * @param userExample
     * @return
     */
    List<User> queryAllByExample(UserExample userExample);
}
